home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / mynr11.zip / MYNR.DOC next >
Text File  |  1994-03-17  |  7KB  |  167 lines
  1. My News Reader (Shareware MSDOS program)
  2.  
  3. This program might be of interest to those users who ,
  4. like me , have a unix account with usenet-news access and
  5. who use nn or similar programs to read those news.
  6. The fuss of configurating and installing various news-packages
  7. on my PC and the unix site (though most are exelent pieces of
  8. software engeneering) always prevented me from installing them.
  9. So I wrote my own No-Fuss NewsReader.
  10.    
  11. The normal procedure when reading usenet-news would be
  12. to go to a terminal, start nn and read the news. 
  13. But often one does not have the time or is not focused 
  14. enough for that task. 
  15. So one would log in, go to one's favorite groups, select all unread 
  16. articles and save each group to a textfile with the 
  17. SHIFT-S option. 
  18. Then the user would compress and copy all files 
  19. to a floppydisk and read them at home...or he would dial up
  20. his or her account and download all the files via zmodem.
  21.  
  22. In any way the user would be stuck with a unintelligible
  23. textfile with hundreds of articles thrown together.
  24.  
  25. Now - since the header of an article is (or should be)
  26. normed in certain ways...
  27.  
  28. (like Xref: ,Path:, From:, Subject: etc)...
  29.  
  30. for example:
  31. Xref: math.fu-berlin.de sci.crypt:19666 alt.privacy:12119 alt.security.pgp:9051
  32. Newsgroups: sci.crypt,alt.privacy,alt.security.pgp
  33. Path: math.fu-berlin.de!zib-berlin.de!netmbx.de!Germany.EU.net!EU.net!howland.reston.ans.net!pipex!uknet!comlab.ox.ac.uk!pcl
  34. From: pcl@foo.oucs.ox.ac.uk (Paul C Leyland)
  35. Subject: Announcing pgptalk
  36. Message-ID: <PCL.94Feb12140955@foo.oucs.ox.ac.uk>
  37. Date: 12 Feb 1994 14:09:55 GMT
  38. Lines: 30
  39.  
  40. ...I wrote a program that analyses those headers and the following 
  41. information and produces a listing of all subjects.
  42. One then can scroll through this listing and mark the articles one
  43. would like to read or simply have the program pick out all subjects 
  44. with a selected keyword in it. This can be done by mouse or by 
  45. keyboard. The marked messages can then be read individually.
  46. The header and the message are displayed in different colors to
  47. make reading more easy. (Subject: is highlighted etc.)
  48. The program even automatically saves the current state if the user wants 
  49. to read the rest of the marked messages at a later time and chooses 
  50. to quit in the middle of one session.
  51.  
  52. Here is a listing with all functions. This helpscreen can be also 
  53. selected by pressing the F1 button in the SCANNING MESSAGE-HEADLINES 
  54. screen.      
  55.  
  56. WHEN SCANNING MESSAGE-HEADLINES                                                 
  57.  
  58.  Arrow UP/Down      decrease/increase message # by 1 
  59.  Page  UP/DOWN      decrease/increase message # by 13 
  60.  SPACE              mark/unmark message for later reading 
  61.                     any replies will be marked/unmarked, too 
  62.  Pos1/End           jump to first/last article
  63.  +/-                mark/unmark all messages 
  64.  F                  FIND Text and mark message 
  65.  S                  SAVE single message 
  66.  RETURN             read the highlighted (red) message 
  67.  Ctrl RETURN        read marked messages 
  68.  ESC                EXIT program when scanning messages 
  69.  
  70.  MOUSE  
  71.  Left button        mark message 
  72.  Right button       unmark message 
  73.                     any replies will be marked/unmarked, too 
  74.  
  75.  WHEN READING A SINGLE MESSAGE                                           
  76.  ESC                EXIT to message scan screen when reading a message 
  77.  any other key      read next page of article 
  78.  
  79.  WHEN READING MARKED MESSAGES                                                
  80.  ESC                EXIT EXIT to message scan screen 
  81.  N                  Skip to next marked message 
  82.  any other key      read next page of article 
  83.  
  84.  
  85. The maximum ammount of subjects the program can handle is something over
  86. 770. If a textfile has more messages the file has to be split and
  87. viewed individually. (770 subjects are roundabout 1.4 MB worth of text!)
  88.  
  89. First the textfile, like any textfile, has to be converted from UNIX into
  90. DOS format. I normally would zip the files in my account, transfer them
  91. onto floppy and decompress them at home. Then I would either use
  92. unix2dos on them or simply use TYPE to convert them. Unix uses just
  93. a return at the end of the line whereas DOS needs a return-newline.
  94.  
  95. (I do not know why, but zipping or lharc'ing generally does the job
  96.  without the use of unix2dos or type...but better be safe)
  97.  
  98. Example : 
  99. The unix-textfile is named news.txt.
  100.  
  101. unix2dos (either on your unix account or at home)
  102. unix2dos news.txt >dosnews.txt  (under UNIX)
  103.  
  104. unix2dos news.txt  (at home)
  105. news.txt is now in DOS format.
  106.  
  107. ...or
  108.  
  109. type
  110. type news.txt >dosnews.txt
  111. dosnews.txt is now in DOS format. 
  112.  
  113.  
  114. Now the program can be started by typing
  115. mynr and the name of the textfile at the dos-prompt.
  116. mynr <textfile>
  117.  
  118. ...and we now are in the message-scan screen. At the top there is
  119. some shareware information and then there is a list of subjects.
  120. Subjects that are colored yellow are >first posts<. Any messages
  121. following in gray are replies to that post.
  122.  
  123. In the middle of the screen is a red bar. It serves the purpose
  124. of marking the current message. If RETURN is pressed, the
  125. message gets read out to you.
  126.  
  127. If >s< is pressed, the message under the red bar is saved to 
  128. a textfile. (you have to give a name for the file first)
  129.  
  130. If SPACE is pressed, the current message is marked magenta for
  131. later viewing. The red bar then scrolls to the next message.
  132.  
  133. With Ctrl RETURN all marked messages can be viewed.
  134.  
  135. With pressing >f< one can mark all messages containing a
  136. certain keyword (you get asked for it).
  137.  
  138. >+< and >-< select or deselect all messages...
  139. ESC quits the program.
  140.  
  141. In the shareware versions all functions can be used but only the
  142. first 50 messages can be viewed to encourage registration. If
  143. you decide to register, the fully functional program and all
  144. future updates are send to you via e-mail.
  145. (since you have access to the usenet, it is safe to assume that 
  146. you have an e-mail adress.)
  147.  
  148. Later versions will have unlimited (only by memory) amount of
  149. subjects, user-defined colors, printer supp. and much more.
  150.  
  151. There is a file called testnews.txt for testing the program on.
  152. use : mynr testnews.txt
  153.  
  154. The FIDO groups used a different header at my site - so try
  155. mynr with the -fido option.
  156. mynr <textfile> -fido
  157.  
  158. -NOTE-
  159. The newsheaders have to stick to the normed design since
  160. my program can only work if it finds the keywords it is
  161. looking for at the right position.
  162. I have tested it on several accounts and it worked fine...
  163. ...but I can not be held responsible for any damage this program
  164. may inflict on you or your system...
  165.  
  166. Soo...if the program messes up, write a mail to niesp@inf.fu-berlin.de.
  167.